Certificado de Registro Nacional de Transportadores Rodoviários de Cargas
- Upload
- Buscar documento
- Modelo
Para efetuar o upload de um documento do tipo Certificado de Registro Nacional de Transportadores Rodoviários de Cargas, basta enviar uma requisição POST conforme demonstrado abaixo. O seu código interno é o 9.
POST URL Ambiente/documents/upload
Header
| Identificador | Valor |
|---|---|
| Content-type | multipart/form-data |
| IDEXA-API-KEY | [api_key] |
Payload
| Parâmetro | Descrição | Obrigatório | Tipo | Exemplos |
|---|---|---|---|---|
| files | Documento(s) a ser(em) processado(s) | Sim | File | "arquivo.pdf" |
| type | Tipo do documento enviado | Sim | Integer | 9 |
| pages | Páginas a serem analisadas (Quando extensão for pdf) | Não | String | "1,2,5-10" |
| externalId | Id externo para controle do documento (não pode repetir) | Não | String | "0001" |
Exemplo
('files',('arquivo.pdf',open('/path/to/file/arquivo.pdf','rb'),'application/pdf'))
{
"type": 9,
"pages": "1,2,5-10",
"externalId": "0001"
}
Retorno
Status code 200
Ao enviar um documento, o retorno 200 dado pela api, irá enviar um objeto data nulo pois a inferência do documento ainda será feita. Para obter o resultado da Inteligência Artificial, é necessário utilizar a requisição vista na próxima sessão.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | C ódigo interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 9 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error, 3-In Progress) | Integer | 0 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, IN_PROGRESS, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 9,
"status": 0,
"statusDesc": "RECEIVED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
Para buscar o resultado do documento processado, disponibilizamos o método GET, mostrado a seguir. Pasta passar no parâmetro id, o UUID recebido no momento do upload.
GET URL Ambiente/documents/[id]
Header
| Identificador | Valor |
|---|---|
| Content-type | application/json |
| IDEXA-API-KEY | [api_key] |
Retorno
Status code 200
Um http code 200 é retornado quando o documento é inserido corretamente.
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| id | Código interno do documento | UUID | "95893394-337c-429c-..." |
| externalId | Id externo para controle do documento (não pode repetir) | String | "0001" |
| type | Tipo do documento enviado | Integer | 9 |
| data | Objeto retornado pela IA | Modelo referente ao tipo do documento | json_object |
| processTime | Tempo de processamento | Float | 10.02232 |
| status | Situação do documento (0-Received, 1-Finished, 2-Error) | Integer | 3 |
| statusDesc | Situação do documento (RECEIVED, FINISHED, ERROR) | String | "FINISHED" |
| createdAt | Horário de criação do registro | Datetime | "01/01/2023 00:00:00.0000" |
| updatedAt | Horário de atualização do registro | Datetime | "01/01/2023 00:00:00.0000" |
Exemplo
{
"id": "bc1bc4ea-8964-4bb7-97cc-2d77d39908d8",
"externalId": "0001",
"type": 9,
"data": {
// Verificar em Modelo o resultado esperado desse documento
},
"processTime": null,
"status": 1,
"statusDesc": "FINISHED",
"createdAt": "2022-10-14 14:38:50.045316",
"updatedAt": "2022-10-14 14:38:50.045316"
}
| Parâmetro | Descrição | Tipo | Exemplos |
|---|---|---|---|
| cnpj | CNPJ | String | 00.000.0000/0000-00 |
| rntrc | Registro RNTRC | String | 0000000 |
| dataEmissao | Data de emissão | String | 21/02/2020 |
| dataValidade | Data de validade | String | 21/02/2020 |